package com.nidu.demo.dept.api;

import com.alibaba.cola.dto.MultiResponse;
import com.alibaba.cola.dto.PageResponse;
import com.alibaba.cola.dto.Response;
import com.alibaba.cola.dto.SingleResponse;
import com.nidu.demo.common.enums.StatusEnum;
import com.nidu.demo.dept.dto.*;

import java.util.Set;

/**
 * 部门服务接口
 *
 * @author auto
 */
public interface SysDepartmentService {

    /**
     * 创建部门
     *
     * @param cmd 部门创建命令
     * @return 创建后的部门信息
     */
    SingleResponse<DepartmentCO> add(DepartmentAddCmd cmd);

    /**
     * 更新部门
     *
     * @param cmd 部门更新命令
     * @return 更新后的部门信息
     */
    SingleResponse<DepartmentCO> update(DepartmentUpdateCmd cmd);

    /**
     * 删除部门
     *
     * @param id 部门ID
     * @return 操作结果
     */
    Response delete(Long id);

    /**
     * 批量删除部门
     * @param ids 部门ID集合
     * @return 操作结果
     */
    Response delete(Set<Long> ids);

    /**
     * 获取部门详情
     *
     * @param id 部门ID
     * @return 部门详情
     */
    SingleResponse<DepartmentCO> getById(Long id);

    /**
     * 查询部门列表
     *
     * @param qry 查询条件
     * @return 部门列表
     */
    MultiResponse<DepartmentCO> list(DepartmentListQry qry);

    /**
     * 查询部门树
     *
     * @param qry 查询条件
     * @return 部门树列表
     */
    MultiResponse<DepartmentTreeCO> tree(DepartmentTreeQry qry);

    /**
     * 分页查询部门
     *
     * @param qry 分页查询条件
     * @return 分页结果
     */
    PageResponse<DepartmentTreeCO> page(DepartmentPageQry qry);

    /**
     * 修改状态
     *
     * @param id 部门Id
     * @param status 状态修改命令
     * @return 操作结果
     */
    Response updateStatus(Long id, StatusEnum status);
}